Sign in

v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB
Token God Mode

Get historical "Token God Mode" (TGM) DEX trades (Beta)

Beta — subject to breaking changes.

Access historical DEX trading transactions for a specific token with temporally-correct trader labels. Labels are resolved at the trade date using label history tables to avoid forward-looking bias.

Key differences from /tgm/dex-trades:

  • Accepts an explicit date_range (no rolling default)
  • Labels resolved at the trade date, not the current state
  • No token_address / traded_token_address in the response
  • No only_smart_money flag — use filters.include_labels instead
post/api/v1beta1/tgm/historical-dex-trades

Request body

chain'base' | 'bnb' | 'ethereum' | 'solana' required

Chains supported for the TGM historical DEX trades endpoint.

token_addressstring required

Token contract address

apply_blacklist_filterboolean

When True, exclude blacklisted addresses from the results. Defaults to True.

Response

Historical TGM DEX trades data